XT - X10 Command TSR Version 01.00 August 1991 Copyright 1991 by Bruce Christensen All rights reserved. Table of Contents 1 Introduction................................................ 3 2 Installation................................................ 4 3 Using XT.................................................... 4 4 XT Details.................................................. 8 5 Power Fail Recovery......................................... 11 6 Removing XT................................................. 12 7 The Initialization file (XT.INI)............................ 12 8 Troubleshooting............................................. 17 9 License Agreement and Registration.......................... 18 Table 1 - COM port assignments.............................. 9 Table 2 - Color Choices..................................... 15 Figure 1 - Module Menu...................................... 5 Figure 2 - Command Menu..................................... 6 XT Command TSR Version 01.00 PAGE 3 1) Introduction and Features: This floppy contains a set of extremely useful DOS utilities for the X10 Computer Interface (CP290). These utilities are being marketed under the try-before-you-buy (Shareware) concept to allow you a complete test of the product before you are required to register. Shareware provides you with low-cost, high-performance software and support. Many features have been added to this product based on input from users. Registration will provide you with the latest updates, and an opportunity to voice your suggestions for new product features. See Section 9.0 - License Agreement and Registration, also the Registration form for more details. XT is a TSR (Terminate-Stay Resident) program written for IBM-PC and compatible computers to control the X10 Computer Interface (CP-290). XT will "pop-up" a menu of all defined modules when the proper hotkey seqence is detected. Once a module is selected, another menu is presented allowing selection of the ON, OFF, and DIM commands. XT utilizes interrupt driven, data buffered, serial communications allowing constant monitoring of all activity generated by the CP-290. Therefore, the current status of each module will be maintained as long as XT is resident in your computers memory. The latest state will be reflected in the menus. While XT was designed to be a resident program in your computers memory, it can be easily removed. In addition, XT can be instructed to operate as any other non-TSR program with the use of a command line switch. This mode somewhat reduces the advanced capabilities of XT, but is useful for quickly controlling any number of home automation devices. XT can examine each modules event list stored in the CP-290 and force every module to its expected state. This is useful for resetting modules after a power failure, or if the CP-290 has been off-line for some time. This feature can be invoked at any time the module menu is displayed, or it may be activated automatically during XT installation. XT may communicate to the CP-290 via COM1...COM4 ports. Default parameters for I/O port assignments and IRQ levels have be selected for most common installations, but these parameters can be easily modified to match your systems configuration. XT is a SHAREWARE program. As I'm sure you are aware, useful programs for the CP-290 are extremely difficult to come by. If you use this program regularly, you are expected to pay for it. The current price for XT is $20.00. This contribution supports future programs for home automation devices as well as provides you with (2) free updates of the program as they are released. A registration form is included in this package. Please register this software and support shareware. XT Command TSR Version 01.00 PAGE 4 2) Installation You will want to copy the contents of this floppy to the same drive and directory in which your X10 software resides. Setting your "PATH" statement will then allow execution of this program from any other drive or directory you're presently in. This may be placed in your AUTOEXEC.BAT file. Ex: SET PATH=C:\DOS; D:\X10;... You should set the XT environment variable to the drive and directory of your initialization files. Setting the XT environment allows the XT program to find a data file containing X10 module information and other items used to customize the interface. This can also be placed in your AUTOEXEC.BAT file. Ex: SET XT=D:\X10 If you don't understand the SET and PATH commands, consult your DOS Users Guide and Users Reference for a more detailed explanation, or see the AUTOEXEC.BAT file supplied with this package for an example. 3) Using XT Once you have installed XT on your computer, you can start it by typing the following at the DOS prompt: XT That's XT followed by pressing the key marked or . This will install XT as a TSR program using the following default parameters: - XT.INI is the default initialization file - COM1 is the default communications port using IO address 0x3F8 and IRQ level 4. - is the activation "hotkey". It's possible that you may have the CP-290 attached to different port. If this is case, see Section 4 - XT Details, for options to specify the correct port. For now, just read on and continue this section. XT should now be resident in your computer. If you did not get the "Completed OK." message, find and correct the problem and restart the program. XT Command TSR Version 01.00 PAGE 5 You activate XT's first menu by pressing the hotkey sequence, in this case, both and keys at the same time. Since you didn't specify an initialization file, XT will use the default (XT.INI) file which contains several sample module definitions, menu colors, etc. The menu should like: Ú Module Description ÄÄÄÄÄÂÄ Addr ÄÂÄ Cmd Ä¿ ³ Garage/Porch_Lights_Gar ³ A 1 ³ ? ³ ³ Living_Room_Lamp ³ A 2 ³ ? ³ ³ Bedroom_Lamp ³ A 3 ³ ? ³ ³ Family_Room_Lamp ³ A 4 ³ ? ³ ³ Flag ³ A 5 ³ ? ³ ³ Plant_Grow_Lights ³ A 6 ³ ? ³ ³ Basement_Computer ³ A 7 ³ ? ³ ³ 386_Computer ³ A 8 ³ ? ³ ³ Playroom ³ B 6 ³ ? ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÙ Figure 1 - Module Menu In this case, there are 9 modules defined. Each module has a name describing its location or function, an address, and the last command that was performed on this module. If your CP-290 has its Basecode set for 'A' (see X10 documentation provided with the CP-290), you should be able to press any one of the 8 keys on the CP-290 and watch the display update the status of that particular module. This holds true with events stored in the CP-290 memory. As events are processed, they will be recognized by XT, and each items status will be reflected in the menu. Now press the key - the menu should disappear. Again, press any key on the CP-290. Now activate the menu by pressing the hotkeys and you should see the correct state of the module you just triggered. Since XT uses interrupt driven, buffered communications with the CP-290, the menu doesn't even have to be displayed in order to record the current status of a module. XT sits in the background processing any information the CP-290 sends it. This information will be displayed when you activate the menu via the hotkey. When the module menu is displayed, a menu highlight bar will be placed on the last module description that was selected. Use the , , , , , or keys to position the highlight bar over the module you want to control. If there are more modules defined than can actually fit in the menu (due to menu location on the screen), the menu will scroll through the list. XT Command TSR Version 01.00 PAGE 6 The following is a list of keys and their actions: - move the highlight bar up 1 row in the menu. When it reaches the first item, it stops. - move the highlight bar down 1 row in the menu. When it reaches the last item, it stops. - the first time this key is pressed, the item displayed at the top of the menu is highlighted. Subsequent presses cause the menu to display the items on the previous page. - the first time this key is pressed, the item displayed at the bottom of the current menu is highlighted. Subsequent presses cause the menu to display the items on the next page. - moves the highlight bar to the very first item in the menu. - moves the highlight bar to the very last item in the menu. - selects the highlighted item and displays the command menu. - leave the module menu, restore screen. When you have selected the item you want to control, press . For this example, choose the last item on the list "Playroom". A command menu will now appear on the screen: ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ Playroom % Level ³ ³ Address: B 6 100 °°°° ³ ³ Status: ? 90 °°°° ³ ³ 80 °°°° ³ ³ Use / keys for 70 °°°° ³ ³ command/brightness. 60 °°°° ³ ³ Press to 50 °°°° ³ ³ activate, aborts. 40 °°°° ³ ³ 30 °°°° ³ ³ On Ü Off Ü Dim Ü 20 °°°° ³ ³ ßßßß ßßßßß ßßßßß 10 °°°° ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Figure 2 - Command Menu XT Command TSR Version 01.00 PAGE 7 The first line displays the module information (Playroom). The second line displays its address (B6). The third line displays its status (?). XT will highlight the action it thinks you will want to perform. For example, if the current status of the device is either On or Dim, XT selects Off so all you have to do is press . Otherwise, use the , , or keys to highlight the action (On, Off, Dim) you want to perform on this module. If you are commanding either a lamp dimmer or wall switch, you have the capability of dimming that module. Use the or keys to select the level percentage. When you've selected the command, press to send the command. The active function will blink letting you know the command is in progress. If all goes well, the command menu will disappear upon completion of the command, and the status will be reflected in the module menu. Each time a command is sent to the CP-290, XT waits for an acknowledgement message. If that message is not received after pre-determined timeout period, the following message will be displayed: ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³Command not acknowledged. ³ ³Check cable, IRQ/IO assignments. ³ ³ ³ ³ Press any key to continue... ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ First, check your cable to make sure you're connected to the CP-290. Next, make sure you've specified the proper COM port (see the "c=" option above). If you're still not communicating with the CP-290, determine the IRQ and I/O Port of your serial port and use the "i=" and "o=" commands. Note: XT will only "popup" when the current video is in non-graphics mode. XT will continue to monitor the CP-290, but activation of the menus will occur once the video is restored to text-based mode. XT Command TSR Version 01.00 PAGE 8 4) XT Details If you have your PATH statement and XT environment set correctly (see previous section), you should be able to install XT into memory by typing the following command at the DOS prompt: XT When XT is invoked without any options, it assumes the following defaults: - the data file containing X10 module descriptions, addresses, and other custom options is called: XT.INI - the COM PORT that the CP-290 is connected to is COM1 (it is assumed that COM1 has its IRQ level set to 4 and the I/O port is located at 3F8 HEX). - memory reserved for the XT program is set at 512 paragraphs (more on this later). - the HotKey combination to activate the menu is , that is, both the CONTROL (labeled as Ctrl on most keyboards) and the left shift key are pressed at the same time. If these defaults do not apply to your system, then you may override these settings by passing the following options to XT when you install it into memory. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ The XT program has the following options: ³ ³ ³ ³ XT [f=filename] [c=comm port] [i=irq] [o=io_addr] [m=memory blocks] ³ ³ [h=hotkey] [+p] [-s] [-t] [+u] [+v] [?] ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ where: [f=filename] - this is the name of the file containing X10 module descriptions, addresses, and other items such as menu color, and menu screen positions. The default file is: XT.INI If you want to specify a different file, such as "FRED.X10", then type: XT f=FRED.X10 XT Command TSR Version 01.00 PAGE 9 [c=comm port] - this allows you to select the serial port for communications with the interface. You may select ports 1...4. For example, if your CP290 is connected to COM3: XT c=3 The default port is: 1 (for COM 1) Note: When using this option, XT assumes that the serial ports in your system are setup according to Table 1. In most cases, these assumptions are valid for COM1 and COM2, but lack of a standard for COM3 and COM4 will probably conflict with your setup if that's where your CP-290 is connected. To compensate for this potential problem, see the [i=irq] and [o=i_o] options later in this section. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ COM1 = I/O address 0x3F8 Interrupt 4 ³ ³ COM2 = " 0x2F8 " 3 ³ ³ COM3 = " 0x3E8 " 4 ³ ³ COM4 = " 0x2E8 " 3 ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Table 1 - COM port assignments [i=irq] - use this option if your communications port uses a different IRQ level than what is "standard" (see Table 1 for the "standard" assignments). The default IRQ level is: 4 (COM1) If your serial port uses IRQ 5, then you must specify it on the command line as: XT i=5 Note: If you can't get the XT program to function correctly (timeouts, etc.), the problem is most likely caused by an improper IRQ assignment. See the Troubleshooting section later in this document for determining your IRQ level. [o=io_addr] - use this option if your communications port uses a different IRQ level than what is "standard" (see Table 1 for the "standard" assignments). The default I/O Port address is: 3F8 HEX (COM1) If your serial port is setup for 2E8 hex, then use: XT o=2E8 XT Command TSR Version 01.00 PAGE 10 [m=memory blocks] - this option is provided to allow you to adjust the amount of memory reserved by XT. This memory is used to store information such as module definitions, saving screen data when a menu pops up, and other internal storage. Ideally, you want to use as little memory as possible, but the amount required depends on how many modules XT is controlling. Too much reserved memory is wasteful, stealing memory from your other DOS applications. Too little reserved memory will most likely cause your system to crash, with DOS displaying the following message: "Memory Allocation Error. System Halted." The amount of memory reserved by XT is in units called "blocks". Each block is 16 bytes. The default number of blocks that XT reserves is 512, or 8192 bytes (16 * 512). This value works with the 9 module defintions contained in the sample file (XT.INI) provided with this package. Finding the right value is pretty much trial and error. If your system crashes, add more reserved memory. For example: XT m=600 Note: System crashes or weird behavior may be the result of other TSR's loaded in your system. See the Troubleshooting section later in this document. [+p] - this option instructs XT to perform its power- failure recovery. After XT is installed, it forces each module to the state the CP-290 thinks it should be in. You must specify [+u] to get the most up-to-date status. [-s] - this option allows you to remove the shadow effect for each displayed window. The advantage to this is twofold: 1) if you don't like shadows... 2) reduces memory requirements. To reduce memory requirements you will also have to adjust the reserved memory (see [m=xxx] option). [-t] - this option will NOT keep XT resident. Once is pressed in the module menu, the program will return to DOS. To use XT again, you must run it from the DOS command line. XT Command TSR Version 01.00 PAGE 11 [+u] - this option uploads all event information from the CP-290 during XT initialization, and displays the expected status of the module in the menu. The advantage of this is that XT will have an accurate picture of the state of each module. The disadvantage is the time required to upload the data from the CP-290. [+v] - this option allows you to turn ON the video "snow" removal logic. You will only need this if your video adapter is one of the older CGA cards. THIS FEATURE IS NOT IMPLEMENTED IN THE THIS VERSION. [?] - this option will display a short list of the options currently accepted by the XT program. 5) Power Fail Recovery XT knows the status of each module controlled by the CP-290 since it is constantly monitoring its communications. In some cases, the actual state of a module may not be the same as the state reported by the CP-290. That is, you may have told the light to go OFF, but it remains ON. One cause of this may be faulty transmission of the command due to noise or weak signals. You can easily repeat the last known command to each module by pressing the letter 'P' whenever the module menu is displayed on the screen. To activate the module menu, press the hotkey combination. When you press 'P', the highlight bar positions itself over the first module in the menu that has a status other than '?'. The command is reissued, and the highlight bar goes to the next module with a known status. Finally, when the last module is scanned, the highlight bar will re-position itself over the original module prior to this sequence. This feature can be invoked automatically during XT installation by including the [+p] and the [+u] options in the command line: XT +p +u The [+u] option tells XT to upload all event information from the CP-290. XT then determines what state each module should be in by looking at the event schedule during the past two days. Using this information, XT has pretty good picture of what's on, and what's not. The [+p] option tells XT to display the module menu and immediately start the command reissue procedure. When the process is done, the menu disappears, and control is returned back to DOS. Using the [+p] and [+u] options is useful for forcing each module to its scheduled state after a power failure. This feature easily restores your home environment if the CP-290 has been off-line for a while. XT Command TSR Version 01.00 PAGE 12 6) Removing XT To remove XT from memory, activate the module menu by pressing the hotkey combination. When the menu is displayed, press the letter 'R' on you keyboard. XT may only be removed from memory providing that no other programs are using the interrupt vectors that XT is monitoring. If these vectors are not being used by another program or TSR, XT will restore the vectors to their original state and remove itself from memory. Otherwise, XT will remain resident and display the following message: ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³Sorry... ³ ³ Can't remove TSR right now. ³ ³ ³ ³ Press any key to continue... ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ XT does not have to be installed and remain resident. Instead, you can run it just like any other program by adding the "-t" option on the command line. This will immediately invoke XT, allowing you to control any module in the menu. When you are finished, simply press and you will be returned to DOS. This method of operation might be suitable for systems that may not have enough memory to support TSR's. One drawback is that you loose the background monitoring capabilities of this program. 7) The Initialization file (XT.INI) To keep XT as small as possible, an initialization file is used to assign names and addresses to all the modules. This file should only be created with a text editor or word processor that saves files in pure ascii format. Any extraneous characters or control codes will cause the XT interpreter to ignore your commands. You may place comments in your initialization file. A comment is delineated by the pound sign character '#'. This character must appear in the first column of the line. # This is an example comment. Comments are ignored by the interpreter. Therefore, comments can be placed in front of commands you do not want interpreted by XT at this time. Blank lines are permitted in the initialization file. These allow you to group similar items together. XT Command TSR Version 01.00 PAGE 13 The "DEFINE" command ================================= The "define" command indicates to XT that you are identifying a module description, its address, and optionally, its state. This also tells XT that you want this module included in the module menu. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ The define command has the following syntax: ³ ³ DEFINE module_description address [state] ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ XT's parser looks for a SPACE character to separate the module description and its address. Therefore, if your module description contains several words, you should use the the underscore character "_" to separate the words but to keep the string contiguous. For example: Ex. 1: define Christmas_lights A10 <--- This is CORRECT Ex. 2: define Porch lights A1 <--- This is WRONG it should appear as... define Porch_lights A1 <--- This is CORRECT Use the optional 'state' parameter if you wish to display a state for a particular module. For instance, since my computer is controlled by an Appliance module, rather than have a "?" in the CMD column of the menu, it would be better to have the menu reflect the actual state of the module. Since I know the computer must be ON, I can force the state with the following command: Ex 3: define 386_Computer A8 ON Valid states are: ON, OFF, DIM. The "WINPOS" command ================================= You have the ability to position the menus (almost) any place you desire. If you place a menu or error window too close to the right edge of your screen (so that the window does not fit), the window will wrap to the left side. The same holds true for windows positioned too close to the bottom of the screen. The only exception to the above warnings applies to the module menu. Since it's possible that you may have more modules than can fit on a screen, the module menu will prevent itself from exceeding the bottom of the screen. It will allow you to scroll through the menu using the cursor keys described earlier. XT Command TSR Version 01.00 PAGE 14 There are three distinct windows in XT - 2 are menus, the other is a message window for displaying errors or warnings. When assigning new locations for the windows, use the following keywords to identify the window: WINPOS1 - the module menu WINPOS2 - the command menu WINPOS3 - the message window (errors or warnings) ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ The WINPOS command has the following syntax: ³ ³ WINPOS? ROW y COL x ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Row and Column coordinates are determined from the upper left hand corner of the screen starting at 0, 0. The default coordinates for each window in XT are as follows: Module menu: WINPOS1 ROW 1 COL 30 Command menu: WINPOS2 ROW 3 COL 2 Error messages: WINPOS3 ROW 18 COL 40 The "COLOR" command ================================= The XT utility uses black and white characters so that its menu displays will initially work on all types of video hardware. If you have a color system, you may alter these defaults to suit your own preferences. This can be accomplished using the COLOR command in the initialization file. When assigning new color schemes for the windows, use the following keywords to identify the window: COLOR1 - the module menu COLOR2 - the command menu COLOR3 - the message window (errors or warnings) ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ The COLOR command has the following syntax: ³ ³ COLOR? foreground_color ON background_color ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ XT Command TSR Version 01.00 PAGE 15 See Table 2 - Color Choices for a list of acceptable color definitions that are recognized by the XT parser. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ Foreground Colors Background Colors ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³ BLACK BLACK ³ ³ BLUE BLUE ³ ³ GREEN GREEN ³ ³ CYAN CYAN ³ ³ RED RED ³ ³ MAGENTA MAGENTA ³ ³ BROWN BROWN ³ ³ LIGHTGRAY LIGHTGRAY ³ ³ DARKGRAY ³ ³ LIGHTBLUE ³ ³ LIGHTGREEN ³ ³ LIGHTCYAN ³ ³ LIGHTRED ³ ³ LIGHTMAGENTA ³ ³ YELLOW ³ ³ WHITE ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Table 2 - Color Choices The default colors for each window in XT are as follows: Module menu: COLOR1 WHITE ON BLACK Command menu: COLOR2 BLACK ON LIGHTGRAY Error messages: COLOR3 WHITE ON BLACK When you assign colors to a window, you are selecting the attributes for the window in general. For instance, in the module menu you are selecting the foreground and background colors for all items in the list. The color scheme for the highlight cursor is also taken from this choice, usually the inverse colors you selected for the main selections. XT Command TSR Version 01.00 PAGE 16 The "UPLOAD" command ================================= Placing an UPLOAD command in the initialization file will perform a scan of all events stored in the CP-290 so that the past status of each module can be determined. XT will look at todays events as well as yesterdays events for each module in order to accurately calculate its status. If there is not enough information, a '?' will appear in the "CMD" column of the module menu. Also, if an event is scheduled to be triggered in SECURITY (random) mode within the current hour, a '?' will be displayed in the "CMD" column. A "+u" in the command line is similar to placing "UPLOAD" in the initialization file. The choice is yours. The "HOTKEY" command ================================= You may select your own "hotkey" combination from the list below: RSHIFT, LSHIFT, ALT, CTRL, CONTROL, SCROLLLOCK, NUMLOCK, CAPSLOCK, INSERT Multiple keys are allowed, for instance, the default hotkey sequence would be entered as: HOTKEY CONTROL LSHIFT When you place the HOTKEY command in the XT.INI file, it will override any selection you may have entered on the command line (the +h=xxxx command). ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ The HOTKEY command has the following syntax: ³ ³ HOTKEY key1 key2 ... ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ XT Command TSR Version 01.00 PAGE 17 8) Troubleshooting A) Conflict with XA.EXE (X10 Command Interpreter) XA.EXE is a program written by this author that allows sending X10 commands from the DOS prompt, from batch files, or series of commands and event information to be downloaded from a file. Early versions of XA.EXE (1.00 through 1.03) would alter the interrupt controller thereby disabling XT.EXE. This version of XT.EXE will now work correctly with XA.EXE (1.04 and later). B) Conflicts with other TSRs This program has attempted to follow the rules that all "good neighbor" TSRs should follow. However, several conflicts may arise with other TSRs loaded in your system. If you experience problems with your other TSRs after installing this one, try changing the order in which the TSRs were loaded. This may alleviate some problems. C) IRQ - Which one is it? If you don't know what IRQ level your serial port is configured for, you have (2) alternatives: 1) Open your computer and look at the DIP switch settings on the serial card (or motherboard). Read the instructions that came with your computer equipment if you've never done this before. 2) Take a wild, stomping guess at the IRQ level. Invoke the program by trying every IRQ level between 2 and 7 (on XT machines), and between 2 and 15 (on AT machines). Call up a menu (by using the HotKey) and issue a command to a module. If you see the LED on the top of the CP-290 go on, then you've just found the right IRQ level. The status of the command should be reflected in the module menu. D) Optimizing memory usage Currently, there is no support for XT to automatically guess the correct amount of ram to reserve for its own use. This task is left up to you. One way to conserve memory is to use the "-s" option on the XT installation command line. XT Command TSR Version 01.00 PAGE 18 9) License Agreement and Registration You may make copies of this program, manual, and other files and give it to your friends, upload it to bulletin boards, or include it in the library of a non-profit computer club. I expressly forbid any for-profit venture from selling this software and documentation, either separately or as part of a "library" diskette. I disclaim any liability for its use, misuse, or abuse, including any direct or indirect actions. The user accepts full responsibility for his or her use of this program. SUPPORT SHAREWARE! If you find this software has any value for you, please send a contribution. Contributions of $20 or more will entitle you to (2) updates of this program as new enhancements are added. Please share this software with others. Your suggestions are always welcome. Send any comments to the address given below, or you may contact me on Prodigy, or America Online. Bruce Christensen 6594 Hudson Ave. Mentor, OH. 44060-4545 Prodigy ID: MHNC39A America Online: AuggieBen This software will be uploaded to the PC-OHIO BBS as new updates become available. Their number is: (216) 381-3320. America Online is a registered service mark of Quantum Computer Services, Inc. Prodigy is a registered service mark and trademark of Prodigy Services Co. X-10 is a registered trademark of X-10 (USA) Inc. ----------------end-of-author's-documentation--------------- Software Library Information: This disk copy provided as a service of Public (software) Library We are not the authors of this program, nor are we associated with the author in any way other than as a distributor of the program in accordance with the author's terms of distribution. Please direct shareware payments and specific questions about this program to the author of the program, whose name appears elsewhere in this documentation. If you have trouble getting in touch with the author, we will do whatever we can to help you with your questions. All programs have been tested and do run. To report problems, please use the form that is in the file PROBLEM.DOC on many of our disks or in other written for- mat with screen printouts, if possible. PsL cannot debug pro- programs over the telephone, though we can answer questions. Disks in the PsL are updated monthly, so if you did not get this disk directly from the PsL, you should be aware that the files in this set may no longer be the current versions. Also, if you got this disk from another vendor and are having prob- lems, be aware that some files may have become corrupted or lost by that vendor. Get a current, working disk from PsL. For a copy of the latest monthly software library newsletter and a list of the 3,000+ disks in the library, call or write Public (software) Library P.O.Box 35705 - F Houston, TX 77235-5705 Orders only: 1-800-2424-PSL MC/Visa/AmEx/Discover Outside of U.S. or in Texas or for general information, Call 1-713-524-6394 PsL also has an outstanding catalog for the Macintosh.